Skip to content

Conversation

@runningcode
Copy link
Contributor

@runningcode runningcode commented Jan 30, 2026

Summary

Adds support for overriding distribution install groups via SentryOptions.DistributionOptions or properties file configuration. The properties file configuration allows future configuration via the Sentry Android Gradle plugin.

Fixes EME-806

Usage

Programmatic Configuration

SentryAndroid.init(this) { options ->
    options.distribution.apply {
        orgSlug = "my-org"
        projectSlug = "my-project"
        orgAuthToken = "token"
        buildConfiguration = "release"
        installGroupsOverride = listOf("internal", "beta-testers")
    }
}

Properties File Configuration

In your sentry-debug-meta.properties file:

io.sentry.distribution.install-groups-override=internal,beta-testers

🤖 Generated with Claude Code

…on options

Allows filtering distribution updates by install groups. Users can now
configure installGroupsOverride in SentryOptions.DistributionOptions to
restrict updates to specific install groups.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@github-actions
Copy link
Contributor

github-actions bot commented Jan 30, 2026

Semver Impact of This PR

🟡 Minor (new features)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).


New Features ✨

Distribution

  • Add installGroupsOverride parameter by runningcode in #5066
  • Add installGroupsOverride parameter by runningcode in #5066

🤖 This preview updates automatically when you update the PR.

@github-actions
Copy link
Contributor

github-actions bot commented Jan 30, 2026

Fails
🚫 Please consider adding a changelog entry for the next release.
Messages
📖 Do not forget to update Sentry-docs with your feature once the pull request gets approved.

Instructions and example for changelog

Please add an entry to CHANGELOG.md to the "Unreleased" section. Make sure the entry includes this PR's number.

Example:

## Unreleased

### Features

- Add installGroupsOverride parameter ([#5066](https://github.com/getsentry/sentry-java/pull/5066))

If none of the above apply, you can opt out of this check by adding #skip-changelog to the PR description or adding a skip-changelog label.

Generated by 🚫 dangerJS against 90e5712

@github-actions
Copy link
Contributor

github-actions bot commented Jan 30, 2026

Performance metrics 🚀

  Plain With Sentry Diff
Startup time 349.35 ms 426.71 ms 77.36 ms
Size 1.58 MiB 2.28 MiB 716.23 KiB

Baseline results on branch: main

Startup times

Revision Plain With Sentry Diff
fcec2f2 357.47 ms 447.32 ms 89.85 ms
ee747ae 374.71 ms 455.18 ms 80.47 ms
1564554 323.06 ms 336.68 ms 13.62 ms
27d7cf8 369.82 ms 422.62 ms 52.80 ms
fcec2f2 314.96 ms 373.66 ms 58.70 ms
951caf7 323.66 ms 392.82 ms 69.16 ms
abf451a 332.82 ms 403.67 ms 70.85 ms
674d437 355.28 ms 504.18 ms 148.90 ms
ee747ae 554.98 ms 611.50 ms 56.52 ms
2387c2c 317.04 ms 354.60 ms 37.56 ms

App size

Revision Plain With Sentry Diff
fcec2f2 1.58 MiB 2.12 MiB 551.50 KiB
ee747ae 1.58 MiB 2.10 MiB 530.95 KiB
1564554 1.58 MiB 2.20 MiB 635.33 KiB
27d7cf8 1.58 MiB 2.12 MiB 549.42 KiB
fcec2f2 1.58 MiB 2.12 MiB 551.50 KiB
951caf7 1.58 MiB 2.13 MiB 558.77 KiB
abf451a 1.58 MiB 2.20 MiB 635.29 KiB
674d437 1.58 MiB 2.10 MiB 530.94 KiB
ee747ae 1.58 MiB 2.10 MiB 530.95 KiB
2387c2c 1.58 MiB 2.13 MiB 559.54 KiB

Previous results on branch: no/add-install-groups-override-distribution

Startup times

Revision Plain With Sentry Diff
8432443 338.37 ms 402.92 ms 64.54 ms

App size

Revision Plain With Sentry Diff
8432443 1.58 MiB 2.19 MiB 619.41 KiB

Adds support for reading installGroupsOverride from sentry-distribution.properties
file at runtime. This allows the Gradle plugin to configure install groups that
will be automatically loaded when the SDK initializes.

The property supports comma-separated values:
io.sentry.distribution.install-groups-override=internal,beta-testers,qa

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@linear
Copy link

linear bot commented Jan 30, 2026

Split the combined changelog entry to properly attribute the
installGroupsOverride parameter to this PR (#5066) and separate
it from the installGroups property added in PR #5062.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@runningcode runningcode enabled auto-merge (squash) February 9, 2026 12:52
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@runningcode runningcode merged commit 9ea89e8 into main Feb 9, 2026
61 of 63 checks passed
@runningcode runningcode deleted the no/add-install-groups-override-distribution branch February 9, 2026 13:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants